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SYSTEM AND USER FILES READ AND PUNCH PROGRAM (LEES) 


DECUS Program Library Write-up 


DECUS No. 8-236 


DESCRIPTION 

The program has been designed for the PDP-8 Dish system. When working with a one-disk 
fm the next^'e" 0 ' ° UtPU ' ° SaVed ^ °" P ‘' per f ° pei ' fhuS leavin 9 maximal space on the disk 

t L h E e E disk n h PUnC -r- 0 t ^° , | SyS,em , file ° n ' he hi 9 h ' s P eed P°P er Ponch and restore it on 

the k ! i " 9 °T ° a '? r occasion - After that only the internal file number and 

the numbers of the used blocks can be different. 

tha e t is r ?o r be foil al T U * ° n u he d - iSk a u SySfem Pr ° gram l?ke Ed * or or FOCAL The procedure 
that to be followed .s much easier than to first load a binary tape and then save it on the 

disk. Moreover, ,t is not necessary to know which memory locations are occupied by the 

: r °T^Tr, aSPeC '°" y deS ' 9ned blnar >' loader ( fhe Program OPLO) you can also use the 
punched disk files as selfstart.ng binary tapes. Even the DEC paper tape^lN loader will 
load these tapes (nonselfstarting). 

As an added feature it is possible to restore the DN1 and SAMI block by copying their 

back-ups. This is performed by typing CONTR/R in Monitor Mode. Therefore it is necessary 
to make a patch in disk blocks 0, 1 and 2 necessary 


LOADING AND SAVING 


^ LOAD J 
*IN-R: ,) 


*OPT-l 




ft 


j. SAVE LEES'. 200-1177;547 ) 










OPERATING PROCEDURES 


L LEES J 
*OPT- S 
*IN-S:DDT X 


*OPT- U 

*IN- S: .DDT X 
* 

*OPT- R 
f S EDITf 

*OPT- R 
f U .SYM | 

*OPT- 


To Read 1ST Time 

.LOAD 

IN:R 

OPT 1 

SA$ 

SAVE OPLO'. 200;200 X 


Punch a system file 

Device and file name are asked 

Now the file is punched 

Punch a user file 

Device and file name are asked 

User file is punched 

Read a user or system file from paper tape 

Input was a system file called EDIT 

Read a user or system file 

Input was a user file called .SYM 

CONTR/C is typed 

Back to Monitor Mode 


RESTORING THE STANDARD DIRECTORY 


To make it possible to copy the standard directory from the back-ups, the following patch has 
to be made (e.g. with SYSLUK, DECUS No. 8-141). 


0.144/ 

1364 

1236 

0.145/ 

5754 

3224 

0.146/ 

0000 

5231 

0.032/ 

7527 

7743 

2.115/ 

7641 

0016 

2.121 / 

0162 

0005 

2.132/ 

0002 

0023 

2.133/ 

7400 

0200 

2.135/ 

7400 

0335 


(Before the dot is the block number, 
after the dot: Address in the block, 
followed by old and new contents.) 
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delete dU ^ H SA ^, bl ° ck h L OS accidentally been overwritten or when you do not want to 

and MO fT"?r/nKn S °" the d “ k ' type CONTR / R in Monitor Mode. Then block 177 
0 of the disk (DN1 and SAMI) are reloaded with block 3 and 4 (back-ups). The 

raw ack of this facility is that it comes instead of the "RUBOUT-feature. " 

MEMORY USAGE AND ERROR EXITS 


Great care has been taken to keep the program (on the disk) 
program itself takes location 200-1177and it uses location 


as small as possible. 


The 


10,11 
136 - 177 
1177 - 2201 
3000 - 3777 
7000 - 7177 
7402 - 7406 

The following error exits are possible: 


1. Error messages of the Command Decoder (option S and U only), 
character, followed by return to Monitor Mode. Possible are: 


They consist of one typed 


Input file not found 

More than one input file has been given 
System device error 
Directory full (cannot occur) 
Miscellaneous error 


r 2 outhe Ch po e « h h| ltS WltH Pr ° gram Counter . 0375 ° r °537: Error return from the system I/O 
i e cause, attempt to write on a hardware protected part of the disk. 

3. A '?' is typed and the program asks for a new option. Possible causes: 

- Wrong option given (not R, S or U) 

- f not answered by CONTiyP 
“ Disk full (option R only) 

- Paper tape has illegal format (for instance: first character 
not LEADE^/TRAILER, but BLANK) 

Erroneous checksum (option R) 

- Directory full (option R) 

- Wrong device letter given (option S or U; *IN- not answered 

by brname) - 
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